home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 453 / changes next >
Encoding:
Text File  |  1990-02-16  |  2.9 KB  |  87 lines
  1.  
  2.               MICRO RTX Version 1.10 Release Notes
  3.  
  4. IMPORTANT
  5.  
  6. Changes to the MICRO RTX kernel that are not reflected in the
  7. manual are documented here.
  8.  
  9. Information in this file superceeds that in the manual.
  10.  
  11. Read this file carefully BEFORE writing any MICRO RTX code.
  12.  
  13.  
  14.  
  15. CONFIGURATION AND INSTALLATION
  16.  
  17. The 'rtxboot.prg' executable file loads the MICRO RTX kernel
  18. and then exits.  It may be loaded into the AUTO folder of the
  19. TOS boot disk, and then MICRO RTX will load each time you boot
  20. the system.
  21.  
  22. If you attempt to run a MICRO RTX application without first
  23. loading the MICRO RTX kernel, your program will not run
  24. (you will get a fatal error message).
  25.  
  26. Once MICRO RTX is loaded, it remains in memory until the
  27. computer is reset or turned off.
  28.  
  29.  
  30. IMPORTANT PROGRAMMING HINTS
  31.  
  32. Programs should never modify system variables directly.  Always
  33. use the system calls to modify system variables.  When you set
  34. a variable directly it immediately affects all running processes
  35. which might be in the middle of a disk I/O or anything else.
  36.  
  37. You must use the system services provided by the Bios to modify
  38. system variables.
  39.  
  40. It is important that one uses the Micro RTX facilities when
  41. synchronizing Interrupt Service Procedures (ISPs) with background
  42. tasks.  Especially cases such as waiting for a certain number of
  43. system ticks in a tight loop that wastes valuable CPU time,
  44. instead of using the Micro RTX p_pause service which allows other
  45. processes to run during the pause interval.
  46.  
  47. The temptation is strong, but these sorts of poor programming
  48. practices will always catch up to you!
  49.  
  50.  
  51. GSX CALLS
  52.  
  53. The GSX system calls are not reentrant and may not be called
  54. by more than one process concurrently (unlike the BIOS and
  55. GEMDOS compatible RTX services).
  56.  
  57. If you want to use several processes to perform GSX graphics
  58. calls, you must implement your own lock-out technique (See
  59. "Message Queues as Semaphores" in the Micro RTX manual).
  60.  
  61.  
  62. NEW SYSTEM CALL
  63.  
  64. There is an additional system call that is not described in the
  65. Micro RTX manual.  It adusts the memory quota allowed in a GEMDOS
  66. Malloc(-1L) call.  Malloc(-1L) in RTX returns the size of the
  67. largest free memory segment.  The maximum value returned by
  68. Malloc(-1L) can be controlled with the following system call:
  69.  
  70.     long Mquota(size)
  71.     long size;
  72.  
  73.     Set the maximum value ever returned by a Malloc(-1L) to
  74.     'size' bytes.  If the 'size' is larger than the biggest
  75.     free memory segment in the system, in has no effect on
  76.     the returned value.  When the largest segment is larger
  77.     than 'size', then Malloc(-1) will return 'size'.
  78.  
  79.     This system calls may be used to limit the amount of
  80.     memory a program may aquire via Malloc(-1).  It is
  81.     usefull for programs that Malloc all available
  82.     memory.
  83.  
  84.     The current quota is returned by the Mquota call. A size
  85.     of -1L has no effect on the quota seting an may be used
  86.     to determine what the quote is set to.
  87.